home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / Epic4_mos / share / epic / help / 6_functions / fromw < prev    next >
Encoding:
Text File  |  2002-10-28  |  990 b   |  29 lines
  1. Synopsis:
  2.    $fromw(<word> <list of words>)
  3.    $tow(<word> <list of words>)
  4.  
  5. Technical:
  6.    These two functions are used to filter a range of words from the given
  7.    input string.  The $fromw() function starts at the first occurrence of the
  8.    specified word, and returns it and all that follow it.  The $tow()
  9.    function is the opposite, returning all words up to and including the
  10.    search word.
  11.  
  12. Practical:
  13.    The mnemonic for these functions are "from word" and "to word".  The
  14.    most important distinction is that they include the search word in the
  15.    return string, where functions like $afterw() and $beforew() do not.
  16.  
  17. Returns:
  18.    list of words
  19.  
  20. Examples:
  21.    $tow(two one two three)           returns "one two"
  22.    $tow(four one two three)          returns nothing, "four" not in list
  23.    $fromw(two one two three)         returns "two three"
  24.    $fromw(four one two three)        returns nothing, "four" not in list
  25.  
  26. See Also:
  27.    afterw(6); beforew(6)
  28.  
  29.